home *** CD-ROM | disk | FTP | other *** search
/ Danny Amor's Online Library / Danny Amor's Online Library - Volume 1.iso / html / faqs / faq / gnu-emacs-faq / part1 < prev    next >
Encoding:
Text File  |  1995-07-25  |  34.8 KB  |  801 lines

  1. Subject: GNU Emacs FAQ (1/5, 1-27): Notation/General/Help/Status
  2. Newsgroups: gnu.emacs.help,comp.emacs,news.answers,comp.answers
  3. From: sbyrnes@rice.edu (Steven Byrnes)
  4. Date: Tue, 4 May 1993 02:52:18 GMT
  5.  
  6. Archive-Name: GNU-Emacs-FAQ/part1
  7. Last-Modified: Sat, 6 Mar 1993 21:13:32 GMT
  8. Last-Posted: Tue, 4 May 1993 02:52:18 GMT
  9.  
  10.                GNU Emacs FAQ: Notation/General/Help/Status
  11.  
  12. If you are viewing this text in a GNU Emacs Buffer, you can type "M-2 C-x $" to
  13. get an overview of just the questions.  Then, when you want to look at the text
  14. of the answers, just type "C-x $".
  15.  
  16. To search for a question numbered XXX, type "M-C-s ^XXX:", followed by a C-r if
  17. that doesn't work, then type ESC to end the search.
  18.  
  19. A `+' in the 78th column means something was inserted on the line.  A `-' means
  20. something was deleted and a `!' means some combination of insertions and
  21. deletions occurred.
  22.  
  23. Full instructions for getting the latest FAQ are in question 22.  Also see the
  24. `Introduction to news.answers' posting in the `news.answers' newsgroup, or send
  25. e-mail to `mail-server@rtfm.mit.edu' with `help' on a body line, or use FTP,
  26. WAIS, or Prospero to rtfm.mit.edu.
  27.  
  28.  
  29.  
  30. Notation Used in FAQ
  31.  
  32.   Skip this section and then come back if you don't understand some of the
  33.   later answers.
  34.   
  35. 1:   What do these mean: C-h, M-C-a, RET, "ESC a", etc.?
  36.   
  37.   C-x means press the `x' key while holding down the Control key.  M-x means
  38.   press the `x' key while holding down the Meta key.  M-C-x means press the
  39.   `x' key while holding down both the Control key and the Meta key.  C-M-a
  40.   is a synonym for M-C-a.  RET, LFD, DEL, ESC, and TAB respectively refer to
  41.   pressing the Return, Linefeed (aka Newline), Delete, Escape, and Tab keys
  42.   and are equivalent to C-m, C-j, C-?, C-[, and C-i.  SPC means press the
  43.   Space bar.
  44.   
  45.   I put any key sequence that is longer than one key (and some single-key
  46.   sequences) inside double quotes or on a line by itself.  Any real spaces
  47.   in such a key sequence should be ignored; only SPC really means press the
  48.   space key.
  49.   
  50.   The ASCII code sent by C-x (except for C-?) is the value that would be
  51.   sent by pressing just `x' minus 96 (or 64 for uppercase `X') and will be
  52.   from 0 to 31.  The ASCII code sent by M-x is the sum of 128 and the ASCII
  53.   code that would be sent by pressing just the `x' key.  Essentially, the
  54.   Control key turns off bits 5 and 6 and the Meta key turns on bit 7.
  55.   
  56.   For further information, see `Characters' and `Keys' in the online manual.
  57.   
  58.   NOTE: C-? (aka DEL) is ASCII code 127.  It is a misnomer to call C-? a
  59.   "control" key, since 127 has both bits 5 and 6 turned ON.  Also, on very
  60.   few keyboards does Control-? generate ASCII code 127.
  61.   
  62. 2:   What does "M-x command" mean?
  63.   
  64.   "M-x command" means type M-x, then type the name of the command, then
  65.   type RET.
  66.   
  67.   M-x (by default) invokes the command `execute-extended-command'.  This
  68.   command allows you to run any Emacs command if you can remember the
  69.   command's name.  If you can't remember the command's name, you can type
  70.   TAB and SPC for completion, and "?" for a list of possibilities.  An Emacs
  71.   "command" is any "interactive" Emacs function.
  72.   
  73.   NOTE: Your system administrator may have bound other key sequences to
  74.   invoke execute-extended-command.  A function key labeled `Do' is a good
  75.   candidate for this.
  76.   
  77.   To run non-interactive Emacs functions, see question 53.
  78.   
  79. 3:   How do I read topic XXX in the on-line manual?
  80.   
  81.   When I refer you to topic XXX in the on-line manual, you can read this
  82.   manual node inside Emacs (assuming nothing is broken) by typing this:
  83.   
  84.     C-h i m emacs RET m XXX RET
  85.   
  86.   This invokes the Info facility.  If you don't already know how to use
  87.   Info, type "?" from within Info.
  88.   
  89.   If I refer you to topic XXX:YYY, you need to type this:
  90.   
  91.     C-h i m emacs RET m XXX RET m YYY RET
  92.   
  93.   WARNING: Your system administrator may not have installed the Info files,
  94.   or may have installed them properly.  In this case you should complain.
  95.   
  96. 4:   What do these mean: etc/SERVICE, src/config.h, lisp/default.el?
  97.   
  98.   These are files that come with GNU Emacs.  The GNU Emacs distribution is
  99.   divided into subdirectories; the important ones are `etc', `lisp', and
  100.   `src'.
  101.   
  102.   If you use GNU Emacs, but don't know where it is kept on your system,
  103.   start Emacs, then type "C-h v exec-directory RET".  The directory name
  104.   displayed by this will be the full pathname of the installed `etc'
  105.   directory.
  106.   
  107.   Some of these files are available individually via FTP or e-mail, see
  108.   question 20.  All are available in the source distribution.
  109.   
  110. 5:   What are FSF, LPF, OSF, GNU, RMS, FTP, and GPL?
  111.   
  112.   FSF == Free Software Foundation
  113.   LPF == League for Programming Freedom
  114.   OSF == Open Software Foundation
  115.   GNU == GNU's Not Unix
  116.   RMS == Richard Matthew Stallman
  117.   FTP == File Transfer Protocol
  118.   GPL == GNU General Public Licence
  119.   
  120.   NOTE: Avoid confusing the FSF, the LPF, and the OSF.  The LPF opposes
  121.   look-and-feel copyrights and software patents.  The FSF aims to make high
  122.   quality free software available for everyone.  The OSF is a commercial
  123.   organization which wants to provide an alternative, standardized version
  124.   of Unix not controlled by AT&T.
  125.   
  126.   NOTE: The word "free" in the title of the Free Software Foundation refers
  127.   to "freedom", not "zero dollars".  Anyone can charge any price for
  128.   GPL-covered software that they want to.  However, in practice, the freedom
  129.   enforced by the GPL leads to low prices, because you can always get the
  130.   software for less money from someone else, because everyone has the right
  131.   to resell or give away GPL-covered software.
  132.   
  133.  
  134.  
  135. General Questions
  136.  
  137. 6:   What is the LPF and why should I join it?
  138.   
  139.   The LPF opposes the expanding danger of software patents and look-and-feel
  140.   copyrights.  To get more information, feel free to contact the LPF via
  141.   e-mail or otherwise.  {You may also contact me, jbw@cs.bu.edu; I will be
  142.   happy to talk with you about the LPF.}  Here is the contact information:
  143.   
  144.     E-mail address: league@prep.ai.mit.edu
  145.     Phone number: (617) 243-4091
  146.     Postal address:
  147.       League for Programming Freedom
  148.       1 Kendall Square, Number 143
  149.       Post Office Box 9171
  150.       Cambridge, MA 02139, USA
  151.   
  152.   Papers describing the LPF's views are available on the internet and also
  153.   from the LPF:
  154.   
  155.     Anonymous FTP:
  156.       /prep.ai.mit.edu:/pub/lpf/
  157.       /archive.cis.ohio-state.edu:pub/lpf/
  158.     Anonymous UUCP:
  159.       osu-cis!~/lpf/*
  160.   
  161. 7:   What is the real legal meaning of the GNU copyleft?
  162.   
  163.   The real legal meaning of the GNU General Public Licence (copyleft) is
  164.   however it is interpreted by a judge.  There has never been a copyright
  165.   infringment case involving the GPL to set any precedents.  Please take any
  166.   discussion regarding this issue to the newsgroup gnu.misc.discuss, which
  167.   was created to hold the extensive flame wars on the subject.
  168.   
  169.   RMS writes:
  170.   
  171.     The legal meaning of the GNU copyleft is less important than the spirit,
  172.     which is that Emacs is a free software project and that work pertaining
  173.     to Emacs should also be free software.  "Free" means that all users have
  174.     the freedom to study, share, change and improve Emacs.  To make sure
  175.     everyone has this freedom, pass along source code when you distribute
  176.     any version of Emacs or a related program, and give the recipients the
  177.     same freedom that you enjoyed.
  178.   
  179. 8:   What are appropriate messages for gnu.emacs.help, gnu.emacs.bug,
  180.  comp.emacs, etc.?
  181.   
  182.   The file etc/MAILINGLISTS discusses the purpose of each GNU mailing-list.
  183.   (See question 20 on how to get a copy.)  For those which are gatewayed
  184.   with newsgroups, it lists both the newsgroup name and the mailing list
  185.   address.
  186.   
  187.   comp.emacs is for discussion of Emacs programs in general.  This
  188.   includes GNU Emacs along with various other implementations like JOVE,
  189.   MicroEmacs, Freemacs, MG, Unipress, CCA, Epsilon, etc.
  190.   
  191.   Many people post GNU Emacs questions to comp.emacs because they don't
  192.   receive any of the gnu.* newsgroups.  Arguments have been made both for
  193.   and against posting GNU-Emacs-specific material to comp.emacs.  You have
  194.   to decide for yourself.
  195.   
  196.   Messages advocating "non-free" software are considered unacceptable on any
  197.   of the gnu.* newsgroups except for gnu.misc.discuss, which was created to
  198.   hold the extensive flame-wars on the subject.  "non-free" software
  199.   includes any software for which the end user can't freely modify the
  200.   source code and exchange enhancements.  Be careful to remove the gnu.*
  201.   groups from the `Newsgroups:' line when posting a followup that recommends
  202.   such software.
  203.   
  204.   gnu.emacs.bug is a place where bug reports appear, but avoid posting bug
  205.   reports to this newsgroup, instead see question 10.
  206.   
  207. 9:   Where can I get old postings to gnu.emacs.help and other GNU groups?
  208.   
  209.   The FSF has maintained archives of all of the GNU mailing lists for many
  210.   years, although there may be some unintentional gaps in coverage.  The
  211.   archive is not particularly well organized or easy to retrieve individual
  212.   postings from, but pretty much everything is there.
  213.   
  214.     Anonymous FTP:
  215.       /prep.ai.mit.edu:/pub/gnu/MailingListArchives/
  216.   
  217.   There is a WAIS database named `comp.emacs' on wais.oit.unc.edu that
  218.   makes available the last few days of articles in comp.emacs.
  219.   
  220. 10:  Where should I report bugs and other problems with GNU Emacs?
  221.   
  222.   The correct way to report GNU Emacs bugs is by e-mail to
  223.   bug-gnu-emacs@prep.ai.mit.edu.  Anything sent here also appears in the
  224.   newsgroup gnu.emacs.bug, but please use e-mail instead of news to submit
  225.   the bug report.  This way a reliable return address is available so you
  226.   can be contacted for further details.
  227.   
  228.   RMS explains:
  229.   
  230.     Sending bug reports to help-gnu-emacs (which has the effect of posting
  231.     on gnu.emacs.help) is undesirable because it takes the time of an
  232.     unnecessarily large group of people, most of whom are just users and
  233.     have no idea how to fix these problem.  bug-gnu-emacs reaches a much
  234.     smaller group of people who are more likely to know what to do and have
  235.     expressed a wish to receive more messages about Emacs than the others.
  236.   
  237.   However, RMS says there are circumstances when it is okay to post to
  238.   gnu.emacs.help:
  239.   
  240.     If you have reported a bug and you don't hear about a possible fix, then
  241.     after a suitable delay (such as a week) it is okay to post on
  242.     gnu.emacs.help asking if anyone can help you.
  243.   
  244.   If you are unsure whether you have a bug, RMS describes how to tell:
  245.   
  246.     ... if Emacs crashes, that is a bug.  If Emacs gets compilation errors
  247.     while building, that is a bug.  If Emacs crashes while building, that is
  248.     a bug.  If Lisp code does not do what the documentation says it does,
  249.     that is a bug.
  250.   
  251. 11:  How do I unsubscribe to this mailing list?
  252.   
  253.   If you are receiving a GNU mailing list named `XXX', you might be able
  254.   to unsubscribe to it by sending a request to the address
  255.   `XXX-request@prep.ai.mit.edu'.  However, this will not work if you are
  256.   not listed on the main mailing list, but instead recieve the mail from a
  257.   distribution point.  In that case, you will have to track down at which
  258.   distribution point you are listed.  Inspecting the `Received:' headers
  259.   on the mail messages may help, along with liberal use of the `EXPN' or
  260.   `VRFY' sendmail commands through `telnet <site-address> smtp'.  Ask your
  261.   postmaster for help.
  262.   
  263. 12:  What is the current address of the FSF?
  264.   
  265.   E-mail address: gnu@prep.ai.mit.edu
  266.   Phone number: (617) 876-3296
  267.   Postal address:
  268.     Free Software Foundation, Inc.
  269.     675 Massachusetts Avenue
  270.     Cambridge, MA 02139, USA
  271.   
  272.  
  273.  
  274. On-line Help, Printed Manuals, Other Sources of Help
  275.  
  276. 13:  I'm just starting GNU Emacs; how do I do basic editing?
  277.   
  278.   Type "C-h t" to invoke the self-paced tutorial.  Typing just C-h is
  279.   how to enter the help system.
  280.   
  281.   WARNING: Your system administrator may have changed C-h to act like DEL to
  282.   deal local keyboards.  You can use M-x help-for-help instead to invoke
  283.   help.  To discover what key (if any) invokes help on your system, type
  284.   "M-x where-is RET help-for-help RET".  This will print a comma-separated
  285.   list of key sequences in the echo area.  Ignore the last character in each
  286.   key sequence listed.  Each of the resulting key sequences invokes help.
  287.   
  288.   NOTE: Emacs's help facility works best if help is invoked by a single key
  289.   whose value should be stored in the variable help-char.  Andrew
  290.   Arensburger <arensb@kong.gsfc.nasa.gov> wrote a patch that allows the help
  291.   facility to work properly when invoked by multiple character sequences.
  292.   
  293. 14:  How do I find out how to do something in GNU Emacs?
  294.   
  295.   There are several methods for finding out how to do things in Emacs.
  296.   
  297.   * The complete text of the Emacs manual is available online via the Info
  298.     hypertext reader.  Type "C-h i" to invoke Info.
  299.   
  300.   * You can order a hardcopy of the manual from the FSF.  See question 15.
  301.   
  302.   * You can get a printed reference card listing commands and keys to invoke
  303.     them.  You can order one from the FSF for $1 (or 10 for $5), or you can
  304.     print your own from the etc/refcard.tex file in the Emacs distribution.
  305.     {Are PostScript versions of this available for FTP?}
  306.   
  307.   * You can list all of the commands whose names contain a certain word
  308.     (actually which match a regular expression) using "C-h a"
  309.     (M-x command-apropos).
  310.   
  311.   * You can list all of the functions and variables whose names contain a
  312.     certain word using M-x apropos.
  313.   
  314.   * There are many other commands in Emacs for getting help and information.
  315.     To get a list of these commands, type "C-h C-h C-h".
  316.   
  317.   NOTE: You may find that command-apropos and apropos are extremely slow
  318.   on your system.  This will be fixed in Emacs 19.  If you can't wait that
  319.   long, there is a fast-apropos.el file available in the Emacs Lisp
  320.   Archive (see question 89) that contains the fix.
  321.   
  322. 15:  How do I get a printed copy of the GNU Emacs manual?
  323.   
  324.   You can order a printed copy of the GNU Emacs manual from the FSF for
  325.   $20.  For 6 or more manuals the price is $13 each.  The price may be
  326.   tax-deductible as a business expense.
  327.   
  328.   The full TeX source for the manual also comes in the `man' directory of
  329.   the Emacs distribution, if you're daring enough to try to print out this
  330.   300 page manual yourself (see question 18).
  331.   
  332.   If you absolutely have to print your own copy, and you don't have TeX, you
  333.   can get a PostScript version via anonymous FTP:
  334.   
  335.     /cs.ubc.ca:pub/archive/gnu/manuals_ps/emacs-18.57.ps.Z                   !
  336.   
  337.   which site requests that you please CONFINE ANY MAJOR FTPING TO LATE
  338.   EVENINGS OR EARLY MORNINGS OUR TIME (pacific time zone, GMT-8)).  A DVI
  339.   version is also available via FTP:
  340.   
  341.     /prep.ai.mit.edu:pub/gnu/emacs-manual-6.0.dvi.Z
  342.   
  343.   If you don't have TeX you can convert the Texinfo sources into
  344.   {t,n,ps}roff format with the `texi2roff' program, which is available via
  345.   anonymous FTP:
  346.   
  347.     /archive.cis.ohio-state.edu:pub/gnu/texi2roff/texi2roff.shar.Z
  348.   
  349.   See also question 14 for how to view the manual online.
  350.   
  351. 16:  Where can I get documentation on GNU Emacs Lisp?
  352.   
  353.   Within Emacs, you can type "C-h f" to get the documentation for a
  354.   function, "C-h v" for a variable.
  355.   
  356.   For more information, obtain the GNU Emacs Lisp Reference Manual for Emacs
  357.   18 under Unix.  It is available from the FSF for $50 (or 5 for $200).  The
  358.   latest revision available for FTP is edition 1.03 dated 28 January 1991.
  359.   
  360.   For online use, a set of pregenerated Info files is available with the
  361.   Texinfo source for the Emacs Lisp manual via anonymous FTP:
  362.   
  363.     /archive.cis.ohio-state.edu:pub/gnu/emacs/
  364.     /prep.ai.mit.edu:pub/gnu/elisp-manual-1.03.tar.Z
  365.   
  366.   (You can also create the Info files from the Texinfo source.)  See
  367.   question 17 for details on how to install these files online.
  368.   
  369.   If you are daring enough to try to print this 550 page manual out
  370.   yourself, for instructions see question 18.
  371.   
  372.   Also, as a popular USENET saying goes, "Use the Force, Read the Source".
  373.   
  374. 17:  How do I install a piece of Texinfo documentation?
  375.   
  376.   First create Info files from the Texinfo files with the `makeinfo'
  377.   program.  makeinfo is available as part of the latest Texinfo package:
  378.   
  379.     /prep.ai.mit.edu:pub/gnu/texinfo-2.14.tar.Z
  380.   
  381.   For information about the Texinfo format, read the Texinfo manual which
  382.   comes with Emacs.  This manual also comes installed in Info format, so you
  383.   can read it online.
  384.   
  385.   Neither texinfo-format-buffer nor the makeinfo program install the
  386.   resulting Info files in Emacs's Info tree.  To install Info files:
  387.   
  388.   1. Move the files to the `info' directory in the installed Emacs
  389.      distribution.  See question 4 if you don't know where that
  390.      is.
  391.   
  392.   2. Edit the file info/dir in the installed Emacs distribution, and add a
  393.      line for the top level node in the Info package that you are
  394.      installing.  Follow the examples are already in this file.  The format
  395.      is:
  396.   
  397.        * Topic: (relative-pathname).  Short description of topic.
  398.   
  399.   If you want to install Info files and you don't have the necessary
  400.   privileges, you have several options:
  401.   
  402.   * Info files don't actually need to be installed before being used.  You
  403.     can feed a file name to the Info-goto-node command (invoked by pressing
  404.     "g" in Info mode) by typing the name of the file in parentheses.  This
  405.     goes to the node named `Top' in that file.  For example, to view a Info
  406.     file named `XXX' in your home directory, you can type this:
  407.   
  408.       C-h i g (~/XXX) RET
  409.   
  410.   * You can create your own Info directory.  You can tell Emacs where the
  411.     Info directory is by setting the value of the variable Info-directory
  412.     to its pathname.  For example, to use a private Info directory which
  413.     is a subdirectory of your home directory named `Info', you could do
  414.     this:
  415.   
  416.       (setq Info-directory (expand-file-name "~/Info"))
  417.   
  418.     You will need a top-level Info file named `dir' in this directory.
  419.     You can include the system-wide Info directory in your private Info
  420.     directory with symbolic links or by copying it.
  421.   
  422.   * You can use an enhanced version of lisp/info.el that handles multiple
  423.     Info directories.  Then you can more easily use a mix of private and
  424.     shared Info files.  Dave Gillespie <daveg@synaptics.com,
  425.     daveg@csvax.cs.caltech.edu> has written one such enhancement and I
  426.     believe there are others.  Dave's info.el also handles compressed Info
  427.     files.
  428.   
  429.     Anonymous FTP:
  430.       /archive.cis.ohio-state.edu:modes/info.el.Z
  431.       /ftp.uu.net:languages/emacs-lisp/modes/info.el.Z                       !
  432.   
  433.     According to Jay Bourland <jayb@math.stanford.edu>, a version of Dave's
  434.     info.el comes with `xinfo' (see question 19).
  435.   
  436. 18:  How do I print a Texinfo file?
  437.   
  438.   NOTE: You can't get nice printed output from Info files; you must still
  439.   have the original Texinfo source file for the manual you want to print.
  440.   
  441.   1. Make sure the first line of the Texinfo file looks like this:
  442.   
  443.        \input texinfo
  444.   
  445.      You may need to alter `texinfo' to the full pathname of the
  446.      texinfo.tex file, which comes with Emacs as man/texinfo.tex (or copy
  447.      or link it into the current directory).
  448.   
  449.   2. tex XXX.texinfo
  450.   
  451.   3. texindex XXX.??
  452.   
  453.      The `texindex' program comes with Emacs as man/texindex.c.
  454.   
  455.   4. tex XXX.texinfo
  456.   
  457.   5. Print the DVI file XXX.dvi in the normal way for printing DVI files
  458.      at your site.
  459.   
  460.   To get more general instructions, retrieve the latest Texinfo package
  461.   mentioned in question 17.
  462.   
  463. 19:  Can I view Info files without using GNU Emacs?
  464.   
  465.   Yes, the `info', `xinfo', and `ivinfo' programs do this.  info uses
  466.   curses, xinfo uses standard X11 libraries, and ivinfo uses InterViews.
  467.   You can get info as part of the latest Texinfo package (see question
  468.   17).  xinfo is available separately:
  469.   
  470.     /prep.ai.mit.edu:pub/gnu/xinfo-1.01.01.tar.Z
  471.     /export.lcs.mit.edu:
  472.   
  473.   ivinfo is available in a comp.sources.misc archive or from Tom Horsley
  474.   <tom@ssd.csd.harris.com>.  For ivinfo, you need Stanford's InterViews C++
  475.   X library, available via anonymous FTP (interviews.stanford.edu).
  476.   
  477. 20:  What informational files are available for GNU Emacs?
  478.   
  479.   This isn't a frequently asked question, but it should be!  A variety of
  480.   informational files about GNU Emacs and relevant aspects of the GNU
  481.   project are available for you to read.
  482.   
  483.   The following files are available in the `etc' directory of the GNU
  484.   Emacs distribution, and also the latest versions are available
  485.   individually via anonymous FTP (prep.ai.mit.edu:/pub/gnu/GNUinfo/):
  486.   
  487.     APPLE -- Why the FSF doen't support GNU Emacs on Apple computers
  488.     DISTRIB -- GNU Emacs Availability Information,
  489.       including the popular "Free Software Foundation Order Form"
  490.     FTP -- How to get GNU Software by Internet FTP or by UUCP
  491.     GNU -- The GNU Manifesto
  492.     INTERVIEW -- Richard Stallman discusses his public-domain
  493.                UNIX-compatible software system
  494.                   with BYTE editors
  495.     MACHINES -- Status of GNU Emacs on Various Machines and Systems
  496.     MAILINGLISTS -- GNU Project Electronic Mailing Lists
  497.     SERVICE -- GNU Service Directory
  498.     SUN-SUPPORT -- including "Using Emacstool with GNU Emacs"
  499.   
  500.   These files are available in the `etc' directory of the GNU Emacs
  501.   distribution:
  502.   
  503.     DIFF -- Differences between GNU Emacs and Twenex Emacs
  504.     CCADIFF -- Differences between GNU Emacs and CCA Emacs
  505.     GOSDIFF -- Differences between GNU Emacs and Gosling (Unipress??) Emacs
  506.     COPYING -- GNU Emacs General Public License
  507.     NEWS -- GNU Emacs News, a history of user-visible changes
  508.     LPF -- Why you should join the League for Programming Freedom
  509.     FAQ -- GNU Emacs Frequently Asked Questions (You're reading it)
  510.     OPTIONS -- a complete explanation of startup option handling
  511.   
  512.   These files are available via anonymous FTP (prep.ai.mit.edu:/pub/gnu/):
  513.   
  514.     tasks -- GNU Task List
  515.     standards.text -- GNU Coding Standards
  516.   
  517.   In addition, all of the above files are available directly from the FSF
  518.   via e-mail.  Of course, please try to get them from a local source
  519.   first.
  520.   
  521.   These additional files are available from the FSF via e-mail:
  522.   
  523.   * GNU's Bulletin, June, 1991 -- this file includes:
  524.       GNU'S Who
  525.       What Is the Free Software Foundation?
  526.       What Is Copyleft?
  527.       A Small Way to Help Free Software
  528.       GNUs Flashes (important recent developments for project GNU)
  529.       Free Software Support (and how to get it!)
  530.       Copyrighted Programming Languages
  531.       AT&T Threatens Users of X Windows (and other software patent threats)
  532.       Project Gutenberg
  533.       GNU Project Status Report
  534.       GNU in Japan
  535.       GNU Wish List
  536.       Help Keep Government Software Free
  537.       GNU Software Available Now
  538.         Contents of the Emacs Tape
  539.         Contents of the Compiler Tape
  540.         Contents of the X11 Tapes
  541.         VMS Emacs and Compiler Tapes
  542.       GNU Documentation
  543.       How to Get GNU Software
  544.       Free Software for Microcomputers
  545.         GNU Software on Apple computers
  546.         GNU Software on the Amiga
  547.         GNU Software on the Atari
  548.         GNUish MS-DOS project
  549.         Freemacs, an Extensible Editor for MS-DOS
  550.       GNU in Japan
  551.       FSF Order Form
  552.       Thank GNUs
  553.   * Legal issues about contributing code to GNU
  554.   * GNU Project Status Report
  555.   
  556.   A collection of past GNU's Bulletins is available via anonymous FTP:
  557.   
  558.     /ftp.funet.fi:pub/gnu/Bulletins/
  559.   
  560. 21:  Where can I get help in installing GNU Emacs?
  561.   
  562.   Look in etc/SERVICE for names of companies and individuals who will sell
  563.   you this type of service.  An up-to-date version of the SERVICE file is
  564.   available on prep.ai.mit.edu (also see question 20).
  565.   
  566. 22:  Where can I get the latest version of this document (the FAQ list)?
  567.   
  568.   The GNU Emacs FAQ is available in several ways:
  569.   
  570.   * Via USENET.  If you can read news, the FAQ should be available in your
  571.     news spool, in both the gnu.emacs.help and comp.emacs newsgroups.  Every
  572.     news reader of which I know will allow you to read any news article that
  573.     is still in the news spool, even if you have read the article before.
  574.     You may need to read the instructions for your news reader to discover
  575.     how to do this.  In `rn', this command will do this for you at the
  576.     article selection level:
  577.   
  578.       ?GNU Emacs FAQ?rc:m
  579.   
  580.     In GNUS, you should type "C-u G" from the *Subject* buffer or "C-u SPC"
  581.     from the *Newsgroup* buffer to view all articles in a newsgroup.
  582.   
  583.     The FAQ articles' message IDs are:
  584.   
  585.       <GNU-Emacs-FAQ-0.1993.05.04.025218@rice.edu>                           !
  586.       <GNU-Emacs-FAQ-1.1993.05.04.025218@rice.edu>                           !
  587.       <GNU-Emacs-FAQ-2.1993.05.04.025218@rice.edu>                           !
  588.       <GNU-Emacs-FAQ-3.1993.05.04.025218@rice.edu>                           !
  589.       <GNU-Emacs-FAQ-4.1993.05.04.025218@rice.edu>                           !
  590.       <GNU-Emacs-FAQ-5.1993.05.04.025218@rice.edu>                           !
  591.   
  592.     If you are viewing this in the GNUS *Article* buffer, you can move point
  593.     within one of the above message IDs and type "r" to fetch the referenced
  594.     article.  Type "o" in the *Article* buffer to restore the previous
  595.     contents.  If this text is not in the GNUS *Article* buffer, use M-r
  596.     from the *Subject* buffer instead.
  597.   
  598.     If the FAQ articles have expired and been deleted from your news spool,
  599.     it might (or might not) do some good to complain to your news
  600.     administrator, because the most recent FAQ should not expire before
  601.     July 3, 1993.                                                            !
  602.   
  603.   * Via anonymous FTP.  You can fetch the FAQ articles via anonymous FTP
  604.   
  605.       /rtfm.mit.edu:pub/usenet/news.answers/GNU-Emacs-FAQ/ part*
  606.   
  607.   * Via e-mail.  You can send the following magical incantation in the body
  608.     of a message to mail-server@rtfm.mit.edu:
  609.   
  610.       send usenet/news.answers/GNU-Emacs-FAQ/part0
  611.       send usenet/news.answers/GNU-Emacs-FAQ/part1
  612.       send usenet/news.answers/GNU-Emacs-FAQ/part2
  613.       send usenet/news.answers/GNU-Emacs-FAQ/part3
  614.       send usenet/news.answers/GNU-Emacs-FAQ/part4
  615.       send usenet/news.answers/GNU-Emacs-FAQ/part5
  616.   
  617.   * Via WAIS.  The GNU Emacs FAQ is available via WAIS indexed on a
  618.     per-question basis from the `faq' database on bigbird.bu.edu on the
  619.     non-standard IP port number of 2210.  This is probably the best way to
  620.     find out if there is something in the FAQ related to your question.  I
  621.     use this myself to answer questions I see posted on gnu.emacs.help.
  622.   
  623.     The articles of the GNU Emacs FAQ are also available from the `usenet'
  624.     database on rtfm.mit.edu (on the standard IP port: 210), along with a
  625.     lot of other FAQ articles.  However, these are all indexed at the whole
  626.     article level instead of at the question level.  This is a better place
  627.     to look if you want to fetch the entire FAQ.
  628.   
  629.   * In the GNU Emacs distribution.  Since GNU Emacs 18.56, the latest
  630.     available version of the FAQ at the time of release has been part of the
  631.     GNU Emacs distribution as file etc/FAQ.  18.59 is the latest version,
  632.     and it was released in October 1992.
  633.   
  634.   * There is an old version of the FAQ list available for FTP in the GNU
  635.     archives at MIT:
  636.   
  637.       /prep.ai.mit.edu:pub/gnu/GNUinfo/FAQ.emacs
  638.   
  639.   * As the very last resort, you can e-mail a request to
  640.     gnu-emacs-faq-maintainers@bigbird.bu.edu.  Don't do this unless you have
  641.     made a serious effort to obtain the FAQ list via one of the methods
  642.     listed above.
  643.   
  644.  
  645.  
  646. Status of Emacs
  647.  
  648. 23:  Where does the name "Emacs" come from?
  649.   
  650.   Emacs originally was an acronym for Editor MACroS.  RMS says he "picked
  651.   the name `Emacs' because `E' was not in use as an abbreviation on ITS at
  652.   the time.".  The first Emacs was a set of macros written in 1976 at MIT by
  653.   RMS for the editor TECO (Text Editor and COrrector (originally Tape Editor
  654.   and COrrector)) under ITS on a PDP-10.  RMS had already extended TECO with
  655.   a "real-time" full screen mode with active keys.  Emacs was started by Guy
  656.   Steele <gls@think.com> as a project to unify the many divergent TECO
  657.   command sets and keybindings at MIT.
  658.   
  659.   Many people have told me that TECO code looks a lot like line noise.  See
  660.   alt.lang.teco if you are interested.  I think someone has written a TECO
  661.    implementation in Emacs Lisp.  It would be an interesting project to run
  662.   the original TECO Emacs inside of GNU Emacs.
  663.   
  664. 24:  What is the latest version of GNU Emacs?
  665.   
  666.   GNU Emacs 18.59 is the current version.  Fixes from 18.57 include better
  667.   mail address parsing, an X visual bell speedup, a call-process
  668.   enhancement, a regexp matching change, the ability to apply a numeric
  669.   argument to a self-inserting digit, getting X resource values from the
  670.   RESOURCE_MANAGER property, more reliable shell mode job control, and a
  671.   change to copy-keymap.  Also, support has been added for many new system
  672.   types.  Fixes from 18.55 include the removal of arbitrary limits on the
  673.   undo facility.
  674.   
  675.   According to the January 1992 GNU's Bulletin, "Emacs 18 maintenance
  676.   continues for simple bug fixes.".
  677.   
  678.   To visit a file with information about what has changed in recent
  679.   versions, type "C-h n".
  680.   
  681. 25:  When will GNU Emacs 19 be available?
  682.   
  683.   Richard Stallman recently (February 19, 1993) posted in gnu.emacs.help     !
  684.   the following:                                                             !
  685.                                                                              !
  686.     People should keep in mind that the successor of Emacs 18 does not       !
  687.     come from Lucid.  Its is GNU Emacs 19.  I still can't say exactly when   !
  688.     public release is going to be, but we are about to start testing at a    !
  689.     number of sites.                                                         !
  690.                                                                              !
  691.     GNU Emacs 19 will support a broad spectrum of machines, like Emacs       !
  692.     18.  Ensuring this is the purpose of the testing we are about to do.     !
  693.                                                                              !
  694.     (Please don't volunteer; we have enough pretesters, and if more people   !
  695.     offer, dealing with those messages will slow things down.)               !
  696.                                                                              !
  697.     Once we make sure it is indeed working reliably on various different     !
  698.     systems, we will have a public beta test release.                        !
  699.                                                                              !
  700.     Emacs 19 does support adding properties to ranges of text, and using     !
  701.     these to switch fonts.  In the future, the Epoch people will help        !
  702.     merge support for variable-width fonts.                                  !
  703.                                                                              !
  704.     Meanwhile, I have almost finished updating the Emacs Lisp manual.  Its   !
  705.     next edition will describe Emacs 19.  There will be an announcement      !
  706.     when we know when this edition will be available.                        !
  707.  
  708.   Lucid has released Lucid GNU Emacs 19.6, which is based on an early        !
  709.   unreleased version of GNU Emacs 19.  This will be similar to Emacs 19 when
  710.   it finally arrives, but they are not the same.  See question 121.
  711.   
  712.   Work has begun on features for Emacs 20.
  713.   
  714. 26:  What is different about GNU Emacs 19?
  715.   
  716.   From the January 1992 GNU's Bulletin:
  717.   
  718.     Version 19 will enter beta test late this year.  Among its new features
  719.     are: before and after change hooks, source-level debugging of Emacs Lisp
  720.     programs, X selection processing (including clipboard selections),
  721.     scrollbars, support for European character sets, floating point numbers,
  722.     per-buffer mouse commands, X resource manager interfacing,
  723.     mouse-tracking, Lisp-level binding of function keys, multiple X windows
  724.     (`screens' to Emacs), a new input system, and buffer allocation, which
  725.     uses a new mechanism capable of returning storage to the system when a
  726.     buffer is killed.
  727.   
  728.     The input stream is now a sequence of Lisp objects, instead of a
  729.     sequence of characters.  This allows a reasonable representation for
  730.     mouse clicks, function keys, menu selections, etc.
  731.   
  732.     Thanks go to Alan Carroll and the people who worked on Epoch for
  733.     generating initial feedback to a multi-windowed Emacs, and to Eric
  734.     Raymond for help in polishing the Emacs 19 Lisp libraries.
  735.   
  736.   The June 1991 GNU's bulletin had this to say about future plans for Emacs:
  737.   
  738.     Features being considered for later releases of Emacs include:
  739.     associating property lists with regions of text in a buffer; multiple
  740.     fonts, color, and pixmaps defined by those properties; different
  741.     visibility conditions for the regions, and for various windows showing
  742.     one buffer; hooks to be run if point or mouse moves outside a certain
  743.     range; incrementally saving undo history in a file; static menu bars;
  744.     and better pop-up menus.
  745.   
  746.   Mention of this feature disappeared in the January 1992 GNU's bulletin:
  747.   
  748.     Emacs 19 supports two styles of multiple windows, one with a separate
  749.     screen for the minibuffer, and another with a minibuffer attached to
  750.     each screen.
  751.   
  752.   Mention of these two proposed features disappeared in the January 1991
  753.   GNU's bulletin:
  754.   
  755.   * Incremental syntax analysis for various programming languages (Leif).
  756.   * A more sophisticated emacsclient/server model, which would provide
  757.     network transparent Emacs widget functionality.
  758.   
  759. 27:  What variants of GNU Emacs exist?
  760.   
  761.   * Nemacs (Nihongo Emacs), which can handle Japanese text, is derived from
  762.     GNU Emacs 18.55.  See question 149.
  763.   
  764.   * Demacs, which can run under MS-DOS on 386 machines, is derived from
  765.     Nemacs.  See question 122.
  766.   
  767.   * Epoch, which has better X support, is derived from GNU Emacs 18.58.
  768.     See question 120 and 92.
  769.   
  770.   * Nepoch (Nihongo Epoch), which can handle Japanese text, is derived from
  771.     Epoch.
  772.   
  773.   * Mule (the MULtilingual Enhancement of GNU Emacs) can handle many
  774.     character sets simultaneously.  It is derived from Emacs 18.58.  It is
  775.     available for FTP:
  776.   
  777.       /sh.wide.ad.jp:/JAPAN/mule/
  778.       /etlport.etl.go.jp:/pub/mule/
  779.   
  780.   * Lucid GNU Emacs is derived from an early unreleased version of GNU Emacs
  781.     19.  See question 121 and 92.
  782.   
  783.  
  784.  
  785. ----------------------------------------------------------------------
  786. Copyright (C) 1990, 1991, 1992 Joseph Brian Wells
  787. Copyright (C) 1992, 1993 Steven Byrnes
  788.  
  789. This list of frequently asked questions about GNU Emacs with answers
  790. ("FAQ") may be translated into other languages, transformed into other
  791. formats (e.g. Texinfo, Info, WWW, WAIS, etc.), and updated with new
  792. information.  The same conditions apply to any derivative of the FAQ as
  793. apply to the FAQ itself.  Every copy of the FAQ must include this notice
  794. or an approved translation, information on who is currently maintaining
  795. the FAQ and how to contact them (including their e-mail address), and
  796. information on where the latest version of the FAQ is archived (including
  797. FTP information).  The FAQ may be copied and redistributed under these
  798. conditions, except that the FAQ may not be embedded in a larger literary
  799. work unless that work itself allows free copying and redistribution.
  800.  
  801.